home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / info-service / gopher / Unix / GopherTools / gee.shar / README.gee < prev    next >
Encoding:
Text File  |  1993-07-11  |  5.4 KB  |  136 lines
  1.  
  2.               gee - gopher environment editor (Beta Test Version)
  3.            copyright (c) Bill Middleton, 1993 - all rights reserved
  4.                             wjm@feenix.metronet.com
  5.          Absolutely No Warranty expressed or implied.  Use with care.
  6.            Send comments, suggestions, and fixes to me please.
  7.  
  8.  
  9. What is gee?
  10.   Gee is a tool for gopher admins to allow quick and easy inspection of, and
  11. changes to, the gopher archive.  It uses a paged display, like the gopher client
  12. itself, and displays files one directory at a time.  Gee is compatible
  13. mostly with older gopher servers, but works ok (i hope) with the
  14. gopher+ server's .name files.  Doesn't work with gn, but it could.
  15.  
  16.  
  17. Where is gee?
  18.   Gee is available here on feenix in the perl scripts archive for gopher 
  19. retrievals.  One can also use the gopher mailserver to obtain it, by sending 
  20. mail to perl-info@feenix.metronet.com with the one-line body: (no subject)
  21.  
  22. send /scripts/gopher/tools/gee/gee.shar
  23.  
  24.   Please remember this is a Beta Test Version for free distribution.  It
  25. needs commentary, and improvements.  The rest is up to you.
  26.  
  27. How does it work?
  28.   You should probably be uid (your gopher id) to use it, as that'll make
  29. the error checking work a little better, but as long has write perms on 
  30. the files and directories in the archive that one attempts to change/add to,
  31. it should be ok.
  32.  
  33.   When it starts, gee ordinarily just cd's to to the toplevel gopher archive 
  34. directory and produces a gopher-like listing of all files/dirs therein.  This
  35. listing is of the form:
  36.  
  37. -------------------------------------------------------------------------------
  38. Num        Name           Type      Path        Host       Port   Numb  Status
  39. -------------------------------------------------------------------------------
  40. [items]
  41. .
  42. .
  43. [last item]
  44. cwd: /toplevel/current/dir  h for help >
  45.  
  46. -------------------------------------------------------------------------------
  47.  
  48. With the fields defined like this:
  49.  
  50.    Num  - selection number
  51.    Name - filename (default), or .cap name or .link/.name Name, if it exists
  52.    Type - Text, Not Text, Dir, or .cap/.link/.name Type, if it exists
  53.    Path - path, or local filename if Path matches in in .cap/.link/.name
  54.    Host - localhost or .cap/.link/.name Host, if it exists
  55.    Port - port (default 70) or .cap/.link/.name Port, if it exists
  56.    Numb - not listed unless it exists in .cap/.link/.name
  57.    Status - results from rudimentary error checks on the items
  58.  
  59.  
  60.  There's an option to use a list of all directories in the archive, 
  61. to allow startup in any directory.  This list also makes moving files 
  62. from one location to any other in the archive very easy, more about it 
  63. later.  Once the screen is displayed, there are a several options you
  64. can take by entering a single character or a number, followed by a <CR>.
  65.  They are:
  66.  
  67. number - view stat and .cap/.link/.name info for file.
  68.       This option displays a window with the stat info from the 
  69.       file/dir/symlink, including whether it is world readable, 
  70.       owner and group, and an error condition if not readable 
  71.       by euid.  Or when dir is not scannabale by euid.
  72.  
  73. c     -  change to a subdirectory or .. , or any directory 
  74.       Change to the directory below this one, or any subdirectory.
  75.       Or change to any other directory, by using the (optional) 
  76.       directory listing.
  77.  
  78. f,b,q  -  forward screen, back screen, or quit
  79.  
  80. !command - execute command in current directory
  81.       
  82.  
  83.  
  84.   After choosing an item to view the stat/display info for, there 
  85. are more options for action on the item itself. They are as follows:
  86.  
  87.  
  88. e  -  change/create displayed info for any item via .cap/file or .link/.name 
  89.       Overwrite the current .cap file, or edit the current .cap 
  90.       file or .link/.name file pertaining to the file.  Or, create 
  91.       displayed info for any item via .cap/file or .link or .name
  92.       You can even convert .cap files to .name entries. 
  93.     
  94. v  -  view/edit item with pager/editor
  95.       The configurable pager, overridden by $ENV{'PAGER'} is used
  96.       to view a file.  This option is given when viewing displayed
  97.       info for the file/dir, as well as when changing/creating 
  98.       displayed info for it.
  99.  
  100. m  -  mv item to any dir in the archive  (optional dir list to spec path)
  101.       mv a file or dir (same fs) to a new directory.  Specify 
  102.       path, or use the optional directory listing.
  103.     
  104. d  -  rm any file in the current directory
  105.       Deletes the selected file.  Use with caution.
  106.  
  107.   Anytime a change is made to the displayed information for a file,
  108. an attemt is made to remove the .cache file in the current directory.
  109. A new one is not created yet, but will be in a future release.  Once
  110. it's decided exactly how it should be done...  :)
  111.  
  112.  
  113.   What is the optional directory listing?
  114.     The directory listing of the archive is created by using another 
  115.    included program, called getdirs.  It starts a find in the configured
  116.    toplevel, and creates a text file with the directory paths 
  117.    from the toplevel. The program is configurable to exclude certain 
  118.    directories, like .cap and .index. 
  119.  
  120.  
  121.   What to do now?
  122.     Assuming you have obtained both the programs and this README, 
  123.     you'll also need my simple ansi screen window library, win.pl.
  124.     It is also available here on feenix, under the perl archive.  Then its
  125.     easy.  Just configure the scripts, gee and getdirs, by editing the 
  126.     configure sections, then start saving time and effort.  And dont
  127.     forget to send me comments, bugs, and fixes.
  128.  
  129.  
  130. Bill
  131.  
  132.  
  133.  
  134.    
  135.  
  136.